home *** CD-ROM | disk | FTP | other *** search
/ Ultimedia 1 / Ultimedia 1.iso / tools / sonstiges / easysound / easysound.readme < prev    next >
Text File  |  1994-08-08  |  4KB  |  132 lines
  1.                               EasySound V1.1
  2.                               ==============
  3.  
  4. Hiya, welcome to EasySound V1.0. This stuff is some piece of code which 
  5. I've written for my MuiPingPong. But now I've had the idea to give this 
  6. IMHO useful toolkit to all of you, and the best thing, I don't want any 
  7. money for it -> it's  Freeware.  I don't  even collect  cash for  MAJOR
  8. UPDATES (because there won't be any) ;-)
  9.  
  10. What can you do with EasySound ?
  11. ================================
  12.  
  13. EasySound is a toolkit to include 8SVX samples in your programs without
  14. too much work. All you have to do is take your favorite sample, turn it
  15. to an include file with iff2src and place 2 easy function calls in your
  16. own program.
  17.  
  18. NEW for EasySound V1.1:
  19.  
  20.     - Plays samples direct off disk.
  21.  
  22. Requirements:
  23. =============
  24.  
  25. I've  compiled  this  stuff  with  the  Dice 3.0 compiler. Therefor the
  26. structure in  the sources  will follow the Dice conventions for storage
  27. qualifiers. If
  28.  
  29.     __chip BYTE foobar_data[] = {
  30.             ...
  31.             ...
  32.     }
  33.  
  34. If you're using the SAS C compiler it must look like
  35.  
  36.     BYTE __chip foobar_data[] = {
  37.             ...
  38.             ...
  39.     }
  40.  
  41. All you have to do is changing the printf in  the sources and recompile
  42. it.
  43.  
  44. Installation:
  45. =============
  46.  
  47. I've  decided to  realize this thing as Link Libraries. All you have to
  48. do is  copying the  .lib  files to  your dlib:  directory.  When you're
  49. compiling  your  own  program  you'll  have  to  link  the library with
  50. -leasysound .
  51.  
  52. e.g.
  53.     dcc example.c -leasysound
  54.  
  55. The functions:
  56. ==============
  57.  
  58. Read the easysound.doc file. It contains my own autodocs. :-)
  59.  
  60. Iff2Src:
  61. ========
  62.  
  63. It's quite simple, all you need is an 8svx sample.
  64.  
  65.     iff2src infile name_of_the_array > outfile
  66.  
  67. This will create a header file containing an array like:
  68.  
  69. __chip BYTE name_of_the_array_data[] = {
  70.     .....
  71. };
  72.  
  73. struct SoundInfo *name_of_the_header = {
  74.     name_of_the_header_data, ... , ...
  75. };
  76.  
  77. History:
  78. ========
  79.  
  80. V1.0 - First release. (5.8.94)
  81.  
  82. V1.1 - (7.8.94) Added a function to play samples directly off the disk.
  83.        Added another functiom to flush a sample.
  84.  
  85. Legal stuff:
  86. ============
  87.  
  88. This stuff is Freeware. Do with it whatever you want, but  please be so 
  89. kind and leave my name in the sources and perhaps you could state me in 
  90. your docs.
  91.  
  92. IMPORTANT !! If you want to use this lib for a program that is released
  93. as a SASG program you'll have to send me a free copy  and free  updates
  94. of your program. Sorry folks, but reading the SASG conditions I'll have
  95. to do something like this too.
  96.  
  97. Thank you:
  98. ==========
  99.  
  100. A thank you goes to:
  101.  
  102.     All the people at #amigager for a  lot of fun, I don't mention your 
  103.     names because I'd leave out many  names and I'd like to mention all 
  104.     of you.
  105.  
  106.     But I'd like to say thanks to some people in general.
  107.  
  108.     Jochen Wiedmann for a lot of really useful tools. (flexcat, easylibs, 
  109.         xtract, ...)
  110.  
  111.     Stefan Becker for his incredible Toolmanager.
  112.  
  113.     Dietmar Eilert for GoldED.
  114.  
  115.     Matt Dillon, Dave Baker, Andy Finkel, John Mainwaring,
  116.     Bryce Nesbitt, Mark Schnell & John Toebes for DICE 3.0
  117.  
  118.     My catering service (thanx Mom)
  119.  
  120.     Matthias "DrMabuse" Lühr for Nerv V1.0 (I can't live without it) ;-)
  121.  
  122.     All the people who believe in SUCKS.
  123.  
  124.     and many many many many more.
  125.  
  126. --------------------------------------------------------------------------
  127. Michael Bauer - EMail: bauermichael@student.uni-tuebingen.de
  128. Hegelstr.27     WWW:   http://hp09.zdv.uni-tuebingen.de:4711/
  129. 72072 Tuebingen  Gutgolf@Nightfall , Gutgolf@IRC
  130. Germany
  131.  
  132.